---
layout: docs
page_title: 'nomad server force-leave command reference'
description: >
  The `nomad server force-leave` command forces a server into the left state so that you can eject server nodes that have failed.
---

# `nomad server force-leave` command reference

The `server force-leave` command forces a server to enter the "left" state.
This can be used to eject server nodes which have failed and will not rejoin
the cluster. The failed or left server will be garbage collected after `24h`.

~> Note that if the server is actually still alive, it will
eventually rejoin the cluster again.

## Usage

```plaintext
nomad server force-leave [options] <node>
```

This command expects only one argument - the node which should be forced
to enter the "left" state.

Additionally, by specifying the `prune` flag, a failed or left node can be forcibly removed
from the list of members immediately.

If ACLs are enabled, this option requires a token with the `agent:write`
capability.

## Options

- `-prune`: Removes failed or left server from the Serf member list immediately.
	If member is actually still alive, it will eventually rejoin the cluster again.

## Examples

Force-leave the server "node1":

```shell-session
$ nomad server force-leave node1

```

Force-leave the server "node1" and prune it:

```shell-session
$ nomad server force-leave -prune node1

```

## General options

@include 'general_options_no_namespace.mdx'
